Skip to content

Conversation

@pluflou
Copy link
Collaborator

@pluflou pluflou commented Mar 31, 2025

This initializes the new repository for the Xopt docs site. The workflow in gh-pages.yml would be triggered by the pypi_upload.yml workflows when a new Xopt version is released, as well as when a push/merge is made to the main branch.

For this to be finalized:

  • need to update the url in the settings to deploy to the Xopt docs site, ln 58 in the workflow file (right now it will deploy to the default github.io site which might be good for finalizing the development)
  • need to update the secrets in the xopt-org/Xopt repo to add a token called "DEPLOY_DOCS" that authorizes the dispatch to this repo. The token needs to be fine-grain with read/write on the "Contents" permissions for this repo
  • merge Remove docs files and add dispatch job Xopt#301 that removes the docs deployment workflow from the main repo and adds the dispatch job

@pluflou pluflou changed the title Add docs files and updated workflows Move Xopt docs this to this repo Mar 31, 2025
@pluflou pluflou requested review from Copilot and roussel-ryan March 31, 2025 17:58
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This pull request moves the Xopt documentation into a dedicated repository and introduces a variety of example notebooks, API reference files, and continuous integration workflows for building and deploying the documentation.

  • Adds multiple example notebooks covering Bayesian exploration, GP model creation, genetic algorithms, and basic generator usage.
  • Introduces new API reference pages for major Xopt objects, including generators, evaluators, and VOCS.
  • Configures GitHub Actions for building and deploying the documentation via MkDocs.

Reviewed Changes

Copilot reviewed 54 out of 54 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
docs/examples/multi_objective_bayes_opt/mggpo.ipynb New multi-objective Bayesian optimization example notebook
docs/examples/gp_model_creation/model_creation.ipynb New notebook for building GP models; minor markdown typo detected
docs/examples/ga/nsga2.ipynb New notebook for NSGA-II generator with a few typographical issues
docs/examples/bayes_exp/*.ipynb Additional notebooks demonstrating Bayesian exploration
docs/api/* New API reference pages for Xopt modules and classes
.github/workflows/gh-pages.yml CI/CD workflow for building and deploying the docs
README.md Updated repository title and description

@pluflou pluflou changed the title Move Xopt docs this to this repo Move Xopt docs to this repo Mar 31, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant